Настройка Маx Mini app

В этой статье описано, как настроить чат-бота MAX для работы с Mini App и связать его с Платформой еДА. Настройка выполняется в два этапа: сначала вы создаете бота и получаете нужные данные в личном кабинете MAX Business, затем передаете эти данные в техническую поддержку Платформы еДА.

Оригинальную документацию по настройке ботов можно посмотреть на сайте разработчиков MAX: dev.max.ru.

Нажмите, чтобы перейти https://dev.max.ru/docs/webapps/introduction#%D0%9A%D0%B0%D0%BA%20%D0%B4%D0%BE%D0%B1%D0%B0%D0%B2%D0%B8%D1%82%D1%8C%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20%D0%B2%20MAX

Где находится настройка

  • В MAX: Личный кабинет MAX Business → Чат-боты.

  • На Платформе еДА: Заполнение данных бота выполняется технической поддержкой в настройках портала.

Инструкция

Шаг 1. Перейдите в настройки чат-ботов

  1. Откройте ссылку https://business.max.ru/self/chat-bots.
  2. В открывшемся меню выберите раздел «Чат-боты».

Чат-боты

Шаг 2. Создайте бота или откройте настройки существующего

  1. Нажмите кнопку «Создать», чтобы добавить нового бота.
  2. Если бот уже создан, выберите его из списка и нажмите на три точки, затем выберите «Настройки».

Шаг 3. Укажите ссылку для Mini App

  1. В поле для ввода ссылки (URL) вставьте адрес вашего Mini App на Платформе еДА:

https://[id_компании].max.minia.e-da.site

  1. Вместо [id_компании] подставьте идентификатор вашей компании.

Настройки

Шаг 4. Скопируйте токен бота и никнейм

  1. Найдите поле с токеном бота и скопируйте его значение.
  2. Никому не передавайте токен, кроме специалистов технической поддержки Платформы еДА.
  3. Перейдите в раздел «Основная информация». Скопируйте никнейм (наименование) бота.

Основные

Шаг 5. Передайте данные в техническую поддержку

  1. Отправьте в техническую поддержку Платформы еДА два значения:
  • скопированный токен бота
  • никнейм бота
  1. Специалисты технической поддержки заполнят эти данные в настройках портала Платформы еДА.

Результат

  • Чат-бот в MAX создан и настроен на запуск Mini App.
  • Токен и никнейм бота переданы в техническую поддержку Платформы еДА.
  • На стороне Платформы еДА настройки бота заполнены, интеграция работает.

Как проверить:

  1. Откройте вашего бота в приложении MAX.

  2. Нажмите кнопку запуска Mini App (если она предусмотрена в боте) – приложение должно открыться.

  3. Убедитесь, что в Mini App отображается ваш сайт/каталог на Платформе еДА.

Частые проблемы

Симптом Причина Решение
Mini App не открывается в MAX Неверно указана ссылка или ID компании Проверьте ссылку в настройках бота. Она должна строго соответствовать формату https://[id_компании].max.minia.e-da.site
Бот не реагирует на действия Техническая поддержка еще не заполнила токен на портале Уточните в технической поддержке, применены ли переданные токен и никнейм
Ошибка авторизации в Mini App Устаревший или неверный токен бота Скопируйте токен заново в MAX Business и передайте в техподдержку
Не отображается иконка или название бота Информация не заполнена в MAX Business Перейдите в «Основную информацию» бота в MAX Business и заполните название и аватар
В этом документе